home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / gcc / gcc261a.zoo / info / gcc.info-3 < prev    next >
Encoding:
GNU Info File  |  1994-10-31  |  47.0 KB  |  1,198 lines

  1. This is Info file gcc.info, produced by Makeinfo-1.54 from the input
  2. file gcc.texi.
  3.  
  4.    This file documents the use and the internals of the GNU compiler.
  5.  
  6.    Published by the Free Software Foundation 675 Massachusetts Avenue
  7. Cambridge, MA 02139 USA
  8.  
  9.    Copyright (C) 1988, 1989, 1992, 1993 Free Software Foundation, Inc.
  10.  
  11.    Permission is granted to make and distribute verbatim copies of this
  12. manual provided the copyright notice and this permission notice are
  13. preserved on all copies.
  14.  
  15.    Permission is granted to copy and distribute modified versions of
  16. this manual under the conditions for verbatim copying, provided also
  17. that the sections entitled "GNU General Public License" and "Protect
  18. Your Freedom--Fight `Look And Feel'" are included exactly as in the
  19. original, and provided that the entire resulting derived work is
  20. distributed under the terms of a permission notice identical to this
  21. one.
  22.  
  23.    Permission is granted to copy and distribute translations of this
  24. manual into another language, under the above conditions for modified
  25. versions, except that the sections entitled "GNU General Public
  26. License" and "Protect Your Freedom--Fight `Look And Feel'", and this
  27. permission notice, may be included in translations approved by the Free
  28. Software Foundation instead of in the original English.
  29.  
  30. File: gcc.info,  Node: Optimize Options,  Next: Preprocessor Options,  Prev: Debugging Options,  Up: Invoking GCC
  31.  
  32. Options That Control Optimization
  33. =================================
  34.  
  35.    These options control various sorts of optimizations:
  36.  
  37. `-O'
  38. `-O1'
  39.      Optimize.  Optimizing compilation takes somewhat more time, and a
  40.      lot more memory for a large function.
  41.  
  42.      Without `-O', the compiler's goal is to reduce the cost of
  43.      compilation and to make debugging produce the expected results.
  44.      Statements are independent: if you stop the program with a
  45.      breakpoint between statements, you can then assign a new value to
  46.      any variable or change the program counter to any other statement
  47.      in the function and get exactly the results you would expect from
  48.      the source code.
  49.  
  50.      Without `-O', the compiler only allocates variables declared
  51.      `register' in registers.  The resulting compiled code is a little
  52.      worse than produced by PCC without `-O'.
  53.  
  54.      With `-O', the compiler tries to reduce code size and execution
  55.      time.
  56.  
  57.      When you specify `-O', the compiler turns on `-fthread-jumps' and
  58.      `-fdefer-pop' on all machines.  The compiler turns on
  59.      `-fdelayed-branch' on machines that have delay slots, and
  60.      `-fomit-frame-pointer' on machines that can support debugging even
  61.      without a frame pointer.  On some machines the compiler also turns
  62.      on other flags.
  63.  
  64. `-O2'
  65.      Optimize even more.  GNU CC performs nearly all supported
  66.      optimizations that do not involve a space-speed tradeoff.  The
  67.      compiler does not perform loop unrolling or function inlining when
  68.      you specify `-O2'.  As compared to `-O', this option increases
  69.      both compilation time and the performance of the generated code.
  70.  
  71.      `-O2' turns on all optional optimizations except for loop
  72.      unrolling, function inlining, and, on machines where it interfers
  73.      with debugging, frame pointer elimination.
  74.  
  75. `-O3'
  76.      Optimize yet more.  `-O3' turns on all optimizations specified by
  77.      `-O2' and also turns on the `inline-functions' option.
  78.  
  79. `-O0'
  80.      Do not optimize.
  81.  
  82.      If you use multiple `-O' options, with or without level numbers,
  83.      the last such option is the one that is effective.
  84.  
  85.    Options of the form `-fFLAG' specify machine-independent flags.
  86. Most flags have both positive and negative forms; the negative form of
  87. `-ffoo' would be `-fno-foo'.  In the table below, only one of the forms
  88. is listed--the one which is not the default.  You can figure out the
  89. other form by either removing `no-' or adding it.
  90.  
  91. `-ffloat-store'
  92.      Do not store floating point variables in registers, and inhibit
  93.      other options that might change whether a floating point value is
  94.      taken from a register or memory.
  95.  
  96.      This option prevents undesirable excess precision on machines such
  97.      as the 68000 where the floating registers (of the 68881) keep more
  98.      precision than a `double' is supposed to have.  For most programs,
  99.      the excess precision does only good, but a few programs rely on the
  100.      precise definition of IEEE floating point.  Use `-ffloat-store' for
  101.      such programs.
  102.  
  103. `-fno-default-inline'
  104.      Do not make member functions inline by default merely because they
  105.      are defined inside the class scope (C++ only).  Otherwise, when
  106.      you specify `-O', member functions defined inside class scope are
  107.      compiled inline by default; i.e., you don't need to add `inline'
  108.      in front of the member function name.
  109.  
  110. `-fno-defer-pop'
  111.      Always pop the arguments to each function call as soon as that
  112.      function returns.  For machines which must pop arguments after a
  113.      function call, the compiler normally lets arguments accumulate on
  114.      the stack for several function calls and pops them all at once.
  115.  
  116. `-fforce-mem'
  117.      Force memory operands to be copied into registers before doing
  118.      arithmetic on them.  This may produce better code by making all
  119.      memory references potential common subexpressions.  When they are
  120.      not common subexpressions, instruction combination should
  121.      eliminate the separate register-load.  I am interested in hearing
  122.      about the difference this makes.
  123.  
  124. `-fforce-addr'
  125.      Force memory address constants to be copied into registers before
  126.      doing arithmetic on them.  This may produce better code just as
  127.      `-fforce-mem' may.  I am interested in hearing about the
  128.      difference this makes.
  129.  
  130. `-fomit-frame-pointer'
  131.      Don't keep the frame pointer in a register for functions that
  132.      don't need one.  This avoids the instructions to save, set up and
  133.      restore frame pointers; it also makes an extra register available
  134.      in many functions.  *It also makes debugging impossible on some
  135.      machines.*
  136.  
  137.      On some machines, such as the Vax, this flag has no effect, because
  138.      the standard calling sequence automatically handles the frame
  139.      pointer and nothing is saved by pretending it doesn't exist.  The
  140.      machine-description macro `FRAME_POINTER_REQUIRED' controls
  141.      whether a target machine supports this flag.  *Note Registers::.
  142.  
  143. `-fno-inline'
  144.      Don't pay attention to the `inline' keyword.  Normally this option
  145.      is used to keep the compiler from expanding any functions inline.
  146.      Note that if you are not optimizing, no functions can be expanded
  147.      inline.
  148.  
  149. `-finline-functions'
  150.      Integrate all simple functions into their callers.  The compiler
  151.      heuristically decides which functions are simple enough to be worth
  152.      integrating in this way.
  153.  
  154.      If all calls to a given function are integrated, and the function
  155.      is declared `static', then the function is normally not output as
  156.      assembler code in its own right.
  157.  
  158. `-fkeep-inline-functions'
  159.      Even if all calls to a given function are integrated, and the
  160.      function is declared `static', nevertheless output a separate
  161.      run-time callable version of the function.
  162.  
  163. `-fno-function-cse'
  164.      Do not put function addresses in registers; make each instruction
  165.      that calls a constant function contain the function's address
  166.      explicitly.
  167.  
  168.      This option results in less efficient code, but some strange hacks
  169.      that alter the assembler output may be confused by the
  170.      optimizations performed when this option is not used.
  171.  
  172. `-ffast-math'
  173.      This option allows GCC to violate some ANSI or IEEE rules and/or
  174.      specifications in the interest of optimizing code for speed.  For
  175.      example, it allows the compiler to assume arguments to the `sqrt'
  176.      function are non-negative numbers and that no floating-point values
  177.      are NaNs.
  178.  
  179.      This option should never be turned on by any `-O' option since it
  180.      can result in incorrect output for programs which depend on an
  181.      exact implementation of IEEE or ANSI rules/specifications for math
  182.      functions.
  183.  
  184.    The following options control specific optimizations.  The `-O2'
  185. option turns on all of these optimizations except `-funroll-loops' and
  186. `-funroll-all-loops'.  On most machines, the `-O' option turns on the
  187. `-fthread-jumps' and `-fdelayed-branch' options, but specific machines
  188. may handle it differently.
  189.  
  190.    You can use the following flags in the rare cases when "fine-tuning"
  191. of optimizations to be performed is desired.
  192.  
  193. `-fstrength-reduce'
  194.      Perform the optimizations of loop strength reduction and
  195.      elimination of iteration variables.
  196.  
  197. `-fthread-jumps'
  198.      Perform optimizations where we check to see if a jump branches to a
  199.      location where another comparison subsumed by the first is found.
  200.      If so, the first branch is redirected to either the destination of
  201.      the second branch or a point immediately following it, depending
  202.      on whether the condition is known to be true or false.
  203.  
  204. `-fcse-follow-jumps'
  205.      In common subexpression elimination, scan through jump instructions
  206.      when the target of the jump is not reached by any other path.  For
  207.      example, when CSE encounters an `if' statement with an `else'
  208.      clause, CSE will follow the jump when the condition tested is
  209.      false.
  210.  
  211. `-fcse-skip-blocks'
  212.      This is similar to `-fcse-follow-jumps', but causes CSE to follow
  213.      jumps which conditionally skip over blocks.  When CSE encounters a
  214.      simple `if' statement with no else clause, `-fcse-skip-blocks'
  215.      causes CSE to follow the jump around the body of the `if'.
  216.  
  217. `-frerun-cse-after-loop'
  218.      Re-run common subexpression elimination after loop optimizations
  219.      has been performed.
  220.  
  221. `-fexpensive-optimizations'
  222.      Perform a number of minor optimizations that are relatively
  223.      expensive.
  224.  
  225. `-fdelayed-branch'
  226.      If supported for the target machine, attempt to reorder
  227.      instructions to exploit instruction slots available after delayed
  228.      branch instructions.
  229.  
  230. `-fschedule-insns'
  231.      If supported for the target machine, attempt to reorder
  232.      instructions to eliminate execution stalls due to required data
  233.      being unavailable.  This helps machines that have slow floating
  234.      point or memory load instructions by allowing other instructions
  235.      to be issued until the result of the load or floating point
  236.      instruction is required.
  237.  
  238. `-fschedule-insns2'
  239.      Similar to `-fschedule-insns', but requests an additional pass of
  240.      instruction scheduling after register allocation has been done.
  241.      This is especially useful on machines with a relatively small
  242.      number of registers and where memory load instructions take more
  243.      than one cycle.
  244.  
  245. `-fcaller-saves'
  246.      Enable values to be allocated in registers that will be clobbered
  247.      by function calls, by emitting extra instructions to save and
  248.      restore the registers around such calls.  Such allocation is done
  249.      only when it seems to result in better code than would otherwise
  250.      be produced.
  251.  
  252.      This option is enabled by default on certain machines, usually
  253.      those which have no call-preserved registers to use instead.
  254.  
  255. `-funroll-loops'
  256.      Perform the optimization of loop unrolling.  This is only done for
  257.      loops whose number of iterations can be determined at compile time
  258.      or run time.  `-funroll-loop' implies both `-fstrength-reduce' and
  259.      `-frerun-cse-after-loop'.
  260.  
  261. `-funroll-all-loops'
  262.      Perform the optimization of loop unrolling.  This is done for all
  263.      loops and usually makes programs run more slowly.
  264.      `-funroll-all-loops' implies `-fstrength-reduce' as well as
  265.      `-frerun-cse-after-loop'.
  266.  
  267. `-fno-peephole'
  268.      Disable any machine-specific peephole optimizations.
  269.  
  270. File: gcc.info,  Node: Preprocessor Options,  Next: Assembler Options,  Prev: Optimize Options,  Up: Invoking GCC
  271.  
  272. Options Controlling the Preprocessor
  273. ====================================
  274.  
  275.    These options control the C preprocessor, which is run on each C
  276. source file before actual compilation.
  277.  
  278.    If you use the `-E' option, nothing is done except preprocessing.
  279. Some of these options make sense only together with `-E' because they
  280. cause the preprocessor output to be unsuitable for actual compilation.
  281.  
  282. `-include FILE'
  283.      Process FILE as input before processing the regular input file.
  284.      In effect, the contents of FILE are compiled first.  Any `-D' and
  285.      `-U' options on the command line are always processed before
  286.      `-include FILE', regardless of the order in which they are
  287.      written.  All the `-include' and `-imacros' options are processed
  288.      in the order in which they are written.
  289.  
  290. `-imacros FILE'
  291.      Process FILE as input, discarding the resulting output, before
  292.      processing the regular input file.  Because the output generated
  293.      from FILE is discarded, the only effect of `-imacros FILE' is to
  294.      make the macros defined in FILE available for use in the main
  295.      input.
  296.  
  297.      Any `-D' and `-U' options on the command line are always processed
  298.      before `-imacros FILE', regardless of the order in which they are
  299.      written.  All the `-include' and `-imacros' options are processed
  300.      in the order in which they are written.
  301.  
  302. `-idirafter DIR'
  303.      Add the directory DIR to the second include path.  The directories
  304.      on the second include path are searched when a header file is not
  305.      found in any of the directories in the main include path (the one
  306.      that `-I' adds to).
  307.  
  308. `-iprefix PREFIX'
  309.      Specify PREFIX as the prefix for subsequent `-iwithprefix' options.
  310.  
  311. `-iwithprefix DIR'
  312.      Add a directory to the second include path.  The directory's name
  313.      is made by concatenating PREFIX and DIR, where PREFIX was
  314.      specified previously with `-iprefix'.  If you have not specified a
  315.      prefix yet, the directory containing the installed passes of the
  316.      compiler is used as the default.
  317.  
  318. `-iwithprefixbefore DIR'
  319.      Add a directory to the main include path.  The directory's name is
  320.      made by concatenating PREFIX and DIR, as in the case of
  321.      `-iwithprefix'.
  322.  
  323. `-isystem DIR'
  324.      Add a directory to the beginning of the second include path,
  325.      marking it as a system directory, so that it gets the same special
  326.      treatment as is applied to the standard system directories.
  327.  
  328. `-nostdinc'
  329.      Do not search the standard system directories for header files.
  330.      Only the directories you have specified with `-I' options (and the
  331.      current directory, if appropriate) are searched.  *Note Directory
  332.      Options::, for information on `-I'.
  333.  
  334.      By using both `-nostdinc' and `-I-', you can limit the include-file
  335.      search path to only those directories you specify explicitly.
  336.  
  337. `-undef'
  338.      Do not predefine any nonstandard macros.  (Including architecture
  339.      flags).
  340.  
  341. `-E'
  342.      Run only the C preprocessor.  Preprocess all the C source files
  343.      specified and output the results to standard output or to the
  344.      specified output file.
  345.  
  346. `-C'
  347.      Tell the preprocessor not to discard comments.  Used with the `-E'
  348.      option.
  349.  
  350. `-P'
  351.      Tell the preprocessor not to generate `#line' commands.  Used with
  352.      the `-E' option.
  353.  
  354. `-M'
  355.      Tell the preprocessor to output a rule suitable for `make'
  356.      describing the dependencies of each object file.  For each source
  357.      file, the preprocessor outputs one `make'-rule whose target is the
  358.      object file name for that source file and whose dependencies are
  359.      all the `#include' header files it uses.  This rule may be a
  360.      single line or may be continued with `\'-newline if it is long.
  361.      The list of rules is printed on standard output instead of the
  362.      preprocessed C program.
  363.  
  364.      `-M' implies `-E'.
  365.  
  366.      Another way to specify output of a `make' rule is by setting the
  367.      environment variable `DEPENDENCIES_OUTPUT' (*note Environment
  368.      Variables::.).
  369.  
  370. `-MM'
  371.      Like `-M' but the output mentions only the user header files
  372.      included with `#include "FILE"'.  System header files included
  373.      with `#include <FILE>' are omitted.
  374.  
  375. `-MD'
  376.      Like `-M' but the dependency information is written to a file made
  377.      by replacing ".c" with ".d" at the end of the input file names.
  378.      This is in addition to compiling the file as specified--`-MD' does
  379.      not inhibit ordinary compilation the way `-M' does.
  380.  
  381.      In Mach, you can use the utility `md' to merge multiple dependency
  382.      files into a single dependency file suitable for using with the
  383.      `make' command.
  384.  
  385. `-MMD'
  386.      Like `-MD' except mention only user header files, not system
  387.      header files.
  388.  
  389. `-MG'
  390.      Treat missing header files as generated files and assume they live
  391.      in the same directory as the source file.  If you specify `-MG',
  392.      you must also specify either `-M' or `-MM'.  `-MG' is not
  393.      supported with `-MD' or `-MMD'.
  394.  
  395. `-H'
  396.      Print the name of each header file used, in addition to other
  397.      normal activities.
  398.  
  399. `-AQUESTION(ANSWER)'
  400.      Assert the answer ANSWER for QUESTION, in case it is tested with a
  401.      preprocessor conditional such as `#if #QUESTION(ANSWER)'.  `-A-'
  402.      disables the standard assertions that normally describe the target
  403.      machine.
  404.  
  405. `-DMACRO'
  406.      Define macro MACRO with the string `1' as its definition.
  407.  
  408. `-DMACRO=DEFN'
  409.      Define macro MACRO as DEFN.  All instances of `-D' on the command
  410.      line are processed before any `-U' options.
  411.  
  412. `-UMACRO'
  413.      Undefine macro MACRO.  `-U' options are evaluated after all `-D'
  414.      options, but before any `-include' and `-imacros' options.
  415.  
  416. `-dM'
  417.      Tell the preprocessor to output only a list of the macro
  418.      definitions that are in effect at the end of preprocessing.  Used
  419.      with the `-E' option.
  420.  
  421. `-dD'
  422.      Tell the preprocessing to pass all macro definitions into the
  423.      output, in their proper sequence in the rest of the output.
  424.  
  425. `-dN'
  426.      Like `-dD' except that the macro arguments and contents are
  427.      omitted.  Only `#define NAME' is included in the output.
  428.  
  429. `-trigraphs'
  430.      Support ANSI C trigraphs.  The `-ansi' option also has this effect.
  431.  
  432. File: gcc.info,  Node: Assembler Options,  Next: Link Options,  Prev: Preprocessor Options,  Up: Invoking GCC
  433.  
  434. Passing Options to the Assembler
  435. ================================
  436.  
  437. `-Wa,OPTION'
  438.      Pass OPTION as an option to the assembler.  If OPTION contains
  439.      commas, it is split into multiple options at the commas.
  440.  
  441. File: gcc.info,  Node: Link Options,  Next: Directory Options,  Prev: Assembler Options,  Up: Invoking GCC
  442.  
  443. Options for Linking
  444. ===================
  445.  
  446.    These options come into play when the compiler links object files
  447. into an executable output file.  They are meaningless if the compiler is
  448. not doing a link step.
  449.  
  450. `OBJECT-FILE-NAME'
  451.      A file name that does not end in a special recognized suffix is
  452.      considered to name an object file or library.  (Object files are
  453.      distinguished from libraries by the linker according to the file
  454.      contents.)  If linking is done, these object files are used as
  455.      input to the linker.
  456.  
  457. `-c'
  458. `-S'
  459. `-E'
  460.      If any of these options is used, then the linker is not run, and
  461.      object file names should not be used as arguments.  *Note Overall
  462.      Options::.
  463.  
  464. `-lLIBRARY'
  465.      Search the library named LIBRARY when linking.
  466.  
  467.      It makes a difference where in the command you write this option;
  468.      the linker searches processes libraries and object files in the
  469.      order they are specified.  Thus, `foo.o -lz bar.o' searches
  470.      library `z' after file `foo.o' but before `bar.o'.  If `bar.o'
  471.      refers to functions in `z', those functions may not be loaded.
  472.  
  473.      The linker searches a standard list of directories for the library,
  474.      which is actually a file named `libLIBRARY.a'.  The linker then
  475.      uses this file as if it had been specified precisely by name.
  476.  
  477.      The directories searched include several standard system
  478.      directories plus any that you specify with `-L'.
  479.  
  480.      Normally the files found this way are library files--archive files
  481.      whose members are object files.  The linker handles an archive
  482.      file by scanning through it for members which define symbols that
  483.      have so far been referenced but not defined.  But if the file that
  484.      is found is an ordinary object file, it is linked in the usual
  485.      fashion.  The only difference between using an `-l' option and
  486.      specifying a file name is that `-l' surrounds LIBRARY with `lib'
  487.      and `.a' and searches several directories.
  488.  
  489. `-lobjc'
  490.      You need this special case of the `-l' option in order to link an
  491.      Objective C program.
  492.  
  493. `-nostartfiles'
  494.      Do not use the standard system startup files when linking.  The
  495.      standard libraries are used normally.
  496.  
  497. `-nostdlib'
  498.      Do not use the standard system libraries and startup files when
  499.      linking.  Only the files you specify will be passed to the linker.
  500.  
  501.      One of the standard libraries bypassed by `-nostdlib' is
  502.      `libgcc.a', a library of internal subroutines that GNU CC uses to
  503.      overcome shortcomings of particular machines, or special needs for
  504.      some languages.  (*Note Interfacing to GNU CC Output: Interface,
  505.      for more discussion of `libgcc.a'.) In most cases, you need
  506.      `libgcc.a' even when you want to avoid other standard libraries.
  507.      In other words, when you specify `-nostdlib' you should usually
  508.      specify `-lgcc' as well.  This ensures that you have no unresolved
  509.      references to internal GNU CC library subroutines.  (For example,
  510.      `__main', used to ensure C++ constructors will be called; *note
  511.      `collect2': Collect2..)
  512.  
  513. `-static'
  514.      On systems that support dynamic linking, this prevents linking
  515.      with the shared libraries.  On other systems, this option has no
  516.      effect.
  517.  
  518. `-shared'
  519.      Produce a shared object which can then be linked with other
  520.      objects to form an executable.  Only a few systems support this
  521.      option.
  522.  
  523. `-symbolic'
  524.      Bind references to global symbols when building a shared object.
  525.      Warn about any unresolved references (unless overridden by the
  526.      link editor option `-Xlinker -z -Xlinker defs').  Only a few
  527.      systems support this option.
  528.  
  529. `-Xlinker OPTION'
  530.      Pass OPTION as an option to the linker.  You can use this to
  531.      supply system-specific linker options which GNU CC does not know
  532.      how to recognize.
  533.  
  534.      If you want to pass an option that takes an argument, you must use
  535.      `-Xlinker' twice, once for the option and once for the argument.
  536.      For example, to pass `-assert definitions', you must write
  537.      `-Xlinker -assert -Xlinker definitions'.  It does not work to write
  538.      `-Xlinker "-assert definitions"', because this passes the entire
  539.      string as a single argument, which is not what the linker expects.
  540.  
  541. `-Wl,OPTION'
  542.      Pass OPTION as an option to the linker.  If OPTION contains
  543.      commas, it is split into multiple options at the commas.
  544.  
  545. `-u SYMBOL'
  546.      Pretend the symbol SYMBOL is undefined, to force linking of
  547.      library modules to define it.  You can use `-u' multiple times with
  548.      different symbols to force loading of additional library modules.
  549.  
  550. File: gcc.info,  Node: Directory Options,  Next: Target Options,  Prev: Link Options,  Up: Invoking GCC
  551.  
  552. Options for Directory Search
  553. ============================
  554.  
  555.    These options specify directories to search for header files, for
  556. libraries and for parts of the compiler:
  557.  
  558. `-IDIR'
  559.      Append directory DIR to the list of directories searched for
  560.      include files.
  561.  
  562. `-I-'
  563.      Any directories you specify with `-I' options before the `-I-'
  564.      option are searched only for the case of `#include "FILE"'; they
  565.      are not searched for `#include <FILE>'.
  566.  
  567.      If additional directories are specified with `-I' options after
  568.      the `-I-', these directories are searched for all `#include'
  569.      directives.  (Ordinarily *all* `-I' directories are used this way.)
  570.  
  571.      In addition, the `-I-' option inhibits the use of the current
  572.      directory (where the current input file came from) as the first
  573.      search directory for `#include "FILE"'.  There is no way to
  574.      override this effect of `-I-'.  With `-I.' you can specify
  575.      searching the directory which was current when the compiler was
  576.      invoked.  That is not exactly the same as what the preprocessor
  577.      does by default, but it is often satisfactory.
  578.  
  579.      `-I-' does not inhibit the use of the standard system directories
  580.      for header files.  Thus, `-I-' and `-nostdinc' are independent.
  581.  
  582. `-LDIR'
  583.      Add directory DIR to the list of directories to be searched for
  584.      `-l'.
  585.  
  586. `-BPREFIX'
  587.      This option specifies where to find the executables, libraries,
  588.      include files, and data files of the compiler itself.
  589.  
  590.      The compiler driver program runs one or more of the subprograms
  591.      `cpp', `cc1', `as' and `ld'.  It tries PREFIX as a prefix for each
  592.      program it tries to run, both with and without `MACHINE/VERSION/'
  593.      (*note Target Options::.).
  594.  
  595.      For each subprogram to be run, the compiler driver first tries the
  596.      `-B' prefix, if any.  If that name is not found, or if `-B' was
  597.      not specified, the driver tries two standard prefixes, which are
  598.      `/usr/lib/gcc/' and `/usr/local/lib/gcc-lib/'.  If neither of
  599.      those results in a file name that is found, the unmodified program
  600.      name is searched for using the directories specified in your
  601.      `PATH' environment variable.
  602.  
  603.      `-B' prefixes that effectively specify directory names also apply
  604.      to libraries in the linker, because the compiler translates these
  605.      options into `-L' options for the linker.  They also apply to
  606.      includes files in the preprocessor, because the compiler
  607.      translates these options into `-isystem' options for the
  608.      preprocessor.  In this case, the compiler appends `include' to the
  609.      prefix.
  610.  
  611.      The run-time support file `libgcc.a' can also be searched for using
  612.      the `-B' prefix, if needed.  If it is not found there, the two
  613.      standard prefixes above are tried, and that is all.  The file is
  614.      left out of the link if it is not found by those means.
  615.  
  616.      Another way to specify a prefix much like the `-B' prefix is to use
  617.      the environment variable `GCC_EXEC_PREFIX'.  *Note Environment
  618.      Variables::.
  619.  
  620. File: gcc.info,  Node: Target Options,  Next: Submodel Options,  Prev: Directory Options,  Up: Invoking GCC
  621.  
  622. Specifying Target Machine and Compiler Version
  623. ==============================================
  624.  
  625.    By default, GNU CC compiles code for the same type of machine that
  626. you are using.  However, it can also be installed as a cross-compiler,
  627. to compile for some other type of machine.  In fact, several different
  628. configurations of GNU CC, for different target machines, can be
  629. installed side by side.  Then you specify which one to use with the
  630. `-b' option.
  631.  
  632.    In addition, older and newer versions of GNU CC can be installed side
  633. by side.  One of them (probably the newest) will be the default, but
  634. you may sometimes wish to use another.
  635.  
  636. `-b MACHINE'
  637.      The argument MACHINE specifies the target machine for compilation.
  638.      This is useful when you have installed GNU CC as a cross-compiler.
  639.  
  640.      The value to use for MACHINE is the same as was specified as the
  641.      machine type when configuring GNU CC as a cross-compiler.  For
  642.      example, if a cross-compiler was configured with `configure
  643.      i386v', meaning to compile for an 80386 running System V, then you
  644.      would specify `-b i386v' to run that cross compiler.
  645.  
  646.      When you do not specify `-b', it normally means to compile for the
  647.      same type of machine that you are using.
  648.  
  649. `-V VERSION'
  650.      The argument VERSION specifies which version of GNU CC to run.
  651.      This is useful when multiple versions are installed.  For example,
  652.      VERSION might be `2.0', meaning to run GNU CC version 2.0.
  653.  
  654.      The default version, when you do not specify `-V', is controlled
  655.      by the way GNU CC is installed.  Normally, it will be a version
  656.      that is recommended for general use.
  657.  
  658.    The `-b' and `-V' options actually work by controlling part of the
  659. file name used for the executable files and libraries used for
  660. compilation.  A given version of GNU CC, for a given target machine, is
  661. normally kept in the directory `/usr/local/lib/gcc-lib/MACHINE/VERSION'.
  662.  
  663.    Thus, sites can customize the effect of `-b' or `-V' either by
  664. changing the names of these directories or adding alternate names (or
  665. symbolic links).  If in directory `/usr/local/lib/gcc-lib/' the file
  666. `80386' is a link to the file `i386v', then `-b 80386' becomes an alias
  667. for `-b i386v'.
  668.  
  669.    In one respect, the `-b' or `-V' do not completely change to a
  670. different compiler: the top-level driver program `gcc' that you
  671. originally invoked continues to run and invoke the other executables
  672. (preprocessor, compiler per se, assembler and linker) that do the real
  673. work.  However, since no real work is done in the driver program, it
  674. usually does not matter that the driver program in use is not the one
  675. for the specified target and version.
  676.  
  677.    The only way that the driver program depends on the target machine is
  678. in the parsing and handling of special machine-specific options.
  679. However, this is controlled by a file which is found, along with the
  680. other executables, in the directory for the specified version and
  681. target machine.  As a result, a single installed driver program adapts
  682. to any specified target machine and compiler version.
  683.  
  684.    The driver program executable does control one significant thing,
  685. however: the default version and target machine.  Therefore, you can
  686. install different instances of the driver program, compiled for
  687. different targets or versions, under different names.
  688.  
  689.    For example, if the driver for version 2.0 is installed as `ogcc'
  690. and that for version 2.1 is installed as `gcc', then the command `gcc'
  691. will use version 2.1 by default, while `ogcc' will use 2.0 by default.
  692. However, you can choose either version with either command with the
  693. `-V' option.
  694.  
  695. File: gcc.info,  Node: Submodel Options,  Next: Code Gen Options,  Prev: Target Options,  Up: Invoking GCC
  696.  
  697. Hardware Models and Configurations
  698. ==================================
  699.  
  700.    Earlier we discussed the standard option `-b' which chooses among
  701. different installed compilers for completely different target machines,
  702. such as Vax vs. 68000 vs. 80386.
  703.  
  704.    In addition, each of these target machine types can have its own
  705. special options, starting with `-m', to choose among various hardware
  706. models or configurations--for example, 68010 vs 68020, floating
  707. coprocessor or none.  A single installed version of the compiler can
  708. compile for any model or configuration, according to the options
  709. specified.
  710.  
  711.    Some configurations of the compiler also support additional special
  712. options, usually for compatibility with other compilers on the same
  713. platform.
  714.  
  715.    These options are defined by the macro `TARGET_SWITCHES' in the
  716. machine description.  The default for the options is also defined by
  717. that macro, which enables you to change the defaults.
  718.  
  719. * Menu:
  720.  
  721. * M680x0 Options::
  722. * VAX Options::
  723. * SPARC Options::
  724. * Convex Options::
  725. * AMD29K Options::
  726. * ARM Options::
  727. * M88K Options::
  728. * RS/6000 and PowerPC Options::
  729. * RT Options::
  730. * MIPS Options::
  731. * i386 Options::
  732. * HPPA Options::
  733. * Intel 960 Options::
  734. * DEC Alpha Options::
  735. * Clipper Options::
  736. * H8/300 Options::
  737. * System V Options::
  738.  
  739. File: gcc.info,  Node: M680x0 Options,  Next: VAX Options,  Up: Submodel Options
  740.  
  741. M680x0 Options
  742. --------------
  743.  
  744.    These are the `-m' options defined for the 68000 series.  The default
  745. values for these options depends on which style of 68000 was selected
  746. when the compiler was configured; the defaults for the most common
  747. choices are given below.
  748.  
  749. `-m68000'
  750. `-mc68000'
  751.      Generate output for a 68000.  This is the default when the
  752.      compiler is configured for 68000-based systems.
  753.  
  754. `-m68020'
  755. `-mc68020'
  756.      Generate output for a 68020.  This is the default when the
  757.      compiler is configured for 68020-based systems.
  758.  
  759. `-m68881'
  760.      Generate output containing 68881 instructions for floating point.
  761.      This is the default for most 68020 systems unless `-nfp' was
  762.      specified when the compiler was configured.
  763.  
  764. `-m68030'
  765.      Generate output for a 68030.  This is the default when the
  766.      compiler is configured for 68030-based systems.
  767.  
  768. `-m68040'
  769.      Generate output for a 68040.  This is the default when the
  770.      compiler is configured for 68040-based systems.
  771.  
  772.      This option inhibits the use of 68881/68882 instructions that have
  773.      to be emulated by software on the 68040.  If your 68040 does not
  774.      have code to emulate those instructions, use `-m68040'.
  775.  
  776. `-m68020-40'
  777.      Generate output for a 68040, without using any of the new
  778.      instructions.  This results in code which can run relatively
  779.      efficiently on either a 68020/68881 or a 68030 or a 68040.  The
  780.      generated code does use the 68881 instructions that are emulated
  781.      on the 68040.
  782.  
  783. `-mfpa'
  784.      Generate output containing Sun FPA instructions for floating point.
  785.  
  786. `-msoft-float'
  787.      Generate output containing library calls for floating point.
  788.      *Warning:* the requisite libraries are not part of GNU CC.
  789.      Normally the facilities of the machine's usual C compiler are
  790.      used, but this can't be done directly in cross-compilation.  You
  791.      must make your own arrangements to provide suitable library
  792.      functions for cross-compilation.
  793.  
  794. `-mshort'
  795.      Consider type `int' to be 16 bits wide, like `short int'.
  796.  
  797. `-mnobitfield'
  798.      Do not use the bit-field instructions.  The `-m68000' option
  799.      implies `-mnobitfield'.
  800.  
  801. `-mbitfield'
  802.      Do use the bit-field instructions.  The `-m68020' option implies
  803.      `-mbitfield'.  This is the default if you use a configuration
  804.      designed for a 68020.
  805.  
  806. `-mrtd'
  807.      Use a different function-calling convention, in which functions
  808.      that take a fixed number of arguments return with the `rtd'
  809.      instruction, which pops their arguments while returning.  This
  810.      saves one instruction in the caller since there is no need to pop
  811.      the arguments there.
  812.  
  813.      This calling convention is incompatible with the one normally used
  814.      on Unix, so you cannot use it if you need to call libraries
  815.      compiled with the Unix compiler.
  816.  
  817.      Also, you must provide function prototypes for all functions that
  818.      take variable numbers of arguments (including `printf'); otherwise
  819.      incorrect code will be generated for calls to those functions.
  820.  
  821.      In addition, seriously incorrect code will result if you call a
  822.      function with too many arguments.  (Normally, extra arguments are
  823.      harmlessly ignored.)
  824.  
  825.      The `rtd' instruction is supported by the 68010 and 68020
  826.      processors, but not by the 68000.
  827.  
  828. File: gcc.info,  Node: VAX Options,  Next: SPARC Options,  Prev: M680x0 Options,  Up: Submodel Options
  829.  
  830. VAX Options
  831. -----------
  832.  
  833.    These `-m' options are defined for the Vax:
  834.  
  835. `-munix'
  836.      Do not output certain jump instructions (`aobleq' and so on) that
  837.      the Unix assembler for the Vax cannot handle across long ranges.
  838.  
  839. `-mgnu'
  840.      Do output those jump instructions, on the assumption that you will
  841.      assemble with the GNU assembler.
  842.  
  843. `-mg'
  844.      Output code for g-format floating point numbers instead of
  845.      d-format.
  846.  
  847. File: gcc.info,  Node: SPARC Options,  Next: Convex Options,  Prev: VAX Options,  Up: Submodel Options
  848.  
  849. SPARC Options
  850. -------------
  851.  
  852.    These `-m' switches are supported on the SPARC:
  853.  
  854. `-mno-app-regs'
  855. `-mapp-regs'
  856.      Specify `-mapp-regs' to generate output using the global registers
  857.      2 through 4, which the SPARC SVR4 ABI reserves for applications.
  858.      This is the default.
  859.  
  860.      To be fully SVR4 ABI compliant at the cost of some performance
  861.      loss, specify `-mno-app-regs'.  You should compile libraries and
  862.      system software with this option.
  863.  
  864. `-mfpu'
  865. `-mhard-float'
  866.      Generate output containing floating point instructions.  This is
  867.      the default.
  868.  
  869. `-mno-fpu'
  870. `-msoft-float'
  871.      Generate output containing library calls for floating point.
  872.      *Warning:* there is no GNU floating-point library for SPARC.
  873.      Normally the facilities of the machine's usual C compiler are
  874.      used, but this cannot be done directly in cross-compilation.  You
  875.      must make your own arrangements to provide suitable library
  876.      functions for cross-compilation.
  877.  
  878.      `-msoft-float' changes the calling convention in the output file;
  879.      therefore, it is only useful if you compile *all* of a program with
  880.      this option.  In particular, you need to compile `libgcc.a', the
  881.      library that comes with GNU CC, with `-msoft-float' in order for
  882.      this to work.
  883.  
  884. `-mhard-quad-float'
  885.      Generate output containing quad-word (long double) floating point
  886.      instructions.
  887.  
  888. `-msoft-quad-float'
  889.      Generate output containing library calls for quad-word (long
  890.      double) floating point instructions.  The functions called are
  891.      those specified in the SPARC ABI.  This is the default.
  892.  
  893.      As of this writing, there are no sparc implementations that have
  894.      hardware support for the quad-word floating point instructions.
  895.      They all invoke a trap handler for one of these instructions, and
  896.      then the trap handler emulates the effect of the instruction.
  897.      Because of the trap handler overhead, this is much slower than
  898.      calling the ABI library routines.  Thus the `-msoft-quad-float'
  899.      option is the default.
  900.  
  901. `-mno-epilogue'
  902. `-mepilogue'
  903.      With `-mepilogue' (the default), the compiler always emits code for
  904.      function exit at the end of each function.  Any function exit in
  905.      the middle of the function (such as a return statement in C) will
  906.      generate a jump to the exit code at the end of the function.
  907.  
  908.      With `-mno-epilogue', the compiler tries to emit exit code inline
  909.      at every function exit.
  910.  
  911. `-mno-flat'
  912. `-mflat'
  913.      With `-mflat', the compiler does not generate save/restore
  914.      instructions and will use a "flat" or single register window
  915.      calling convention.  This model uses %i7 as the frame pointer and
  916.      is compatible with the normal register window model.  Code from
  917.      either may be intermixed although debugger support is still
  918.      incomplete.  The local registers and the input registers (0-5) are
  919.      still treated as "call saved" registers and will be saved on the
  920.      stack as necessary.
  921.  
  922.      With `-mno-flat' (the default), the compiler emits save/restore
  923.      instructions (except for leaf functions) and is the normal mode of
  924.      operation.
  925.  
  926. `-mno-unaligned-doubles'
  927. `-munaligned-doubles'
  928.      Assume that doubles have 8 byte alignment.  This is the default.
  929.  
  930.      With `-munaligned-doubles', GNU CC assumes that doubles have 8 byte
  931.      alignment only if they are contained in another type, or if they
  932.      have an absolute address.  Otherwise, it assumes they have 4 byte
  933.      alignment.  Specifying this option avoids some rare compatibility
  934.      problems with code generated by other compilers.  It is not the
  935.      default because it results in a performance loss, especially for
  936.      floating point code.
  937.  
  938. `-mv8'
  939. `-msparclite'
  940.      These two options select variations on the SPARC architecture.
  941.  
  942.      By default (unless specifically configured for the Fujitsu
  943.      SPARClite), GCC generates code for the v7 variant of the SPARC
  944.      architecture.
  945.  
  946.      `-mv8' will give you SPARC v8 code.  The only difference from v7
  947.      code is that the compiler emits the integer multiply and integer
  948.      divide instructions which exist in SPARC v8 but not in SPARC v7.
  949.  
  950.      `-msparclite' will give you SPARClite code.  This adds the integer
  951.      multiply, integer divide step and scan (`ffs') instructions which
  952.      exist in SPARClite but not in SPARC v7.
  953.  
  954. `-mcypress'
  955. `-msupersparc'
  956.      These two options select the processor for which the code is
  957.      optimised.
  958.  
  959.      With `-mcypress' (the default), the compiler optimizes code for the
  960.      Cypress CY7C602 chip, as used in the SparcStation/SparcSever 3xx
  961.      series.  This is also apropriate for the older SparcStation 1, 2,
  962.      IPX etc.
  963.  
  964.      With `-msupersparc' the compiler optimizes code for the SuperSparc
  965.      cpu, as used in the SparcStation 10, 1000 and 2000 series. This
  966.      flag also enables use of the full SPARC v8 instruction set.
  967.  
  968.    In a future version of GCC, these options will very likely be
  969. renamed to `-mcpu=cypress' and `-mcpu=supersparc'.
  970.  
  971.    These `-m' switches are supported in addition to the above on SPARC
  972. V9 processors:
  973.  
  974. `-mcode-model=medium-low'
  975.      Generate code for the Medium/Low code model: assume a 32 bit
  976.      address space.  Programs are statically linked, PIC is not
  977.      supported.  Pointers are still 64 bits.
  978.  
  979. `-mcode-model=medium-anywhere'
  980.      Generate code for the Medium/Anywhere code model: assume a 32 bit
  981.      text segment starting at offset 0, and a 32 bit data segment
  982.      starting anywhere (determined at link time).  Programs are
  983.      statically linked, PIC is not supported.  Pointers are still 64
  984.      bits.
  985.  
  986. `-mint64'
  987.      Types long and int are 64 bits.
  988.  
  989. `-mlong32'
  990.      Types long and int are 32 bits.
  991.  
  992. `-mlong64'
  993. `-mint32'
  994.      Type long is 64 bits, and type int is 32 bits.
  995.  
  996. `-mstack-bias'
  997. `-mno-stack-bias'
  998.      With `-mstack-bias', GNU CC assumes that the stack pointer, and
  999.      frame pointer if present, are offset by -2047 which must be added
  1000.      back when making stack frame references.  Otherwise, assume no
  1001.      such offset is present.
  1002.  
  1003. File: gcc.info,  Node: Convex Options,  Next: AMD29K Options,  Prev: SPARC Options,  Up: Submodel Options
  1004.  
  1005. Convex Options
  1006. --------------
  1007.  
  1008.    These `-m' options are defined for Convex:
  1009.  
  1010. `-mc1'
  1011.      Generate output for C1.  The code will run on any Convex machine.
  1012.      The preprocessor symbol `__convex__c1__' is defined.
  1013.  
  1014. `-mc2'
  1015.      Generate output for C2.  Uses instructions not available on C1.
  1016.      Scheduling and other optimizations are chosen for max performance
  1017.      on C2.  The preprocessor symbol `__convex_c2__' is defined.
  1018.  
  1019. `-mc32'
  1020.      Generate output for C32xx.  Uses instructions not available on C1.
  1021.      Scheduling and other optimizations are chosen for max performance
  1022.      on C32.  The preprocessor symbol `__convex_c32__' is defined.
  1023.  
  1024. `-mc34'
  1025.      Generate output for C34xx.  Uses instructions not available on C1.
  1026.      Scheduling and other optimizations are chosen for max performance
  1027.      on C34.  The preprocessor symbol `__convex_c34__' is defined.
  1028.  
  1029. `-mc38'
  1030.      Generate output for C38xx.  Uses instructions not available on C1.
  1031.      Scheduling and other optimizations are chosen for max performance
  1032.      on C38.  The preprocessor symbol `__convex_c38__' is defined.
  1033.  
  1034. `-margcount'
  1035.      Generate code which puts an argument count in the word preceding
  1036.      each argument list.  This is compatible with regular CC, and a few
  1037.      programs may need the argument count word.  GDB and other
  1038.      source-level debuggers do not need it; this info is in the symbol
  1039.      table.
  1040.  
  1041. `-mnoargcount'
  1042.      Omit the argument count word.  This is the default.
  1043.  
  1044. `-mvolatile-cache'
  1045.      Allow volatile references to be cached.  This is the default.
  1046.  
  1047. `-mvolatile-nocache'
  1048.      Volatile references bypass the data cache, going all the way to
  1049.      memory.  This is only needed for multi-processor code that does
  1050.      not use standard synchronization instructions.  Making
  1051.      non-volatile references to volatile locations will not necessarily
  1052.      work.
  1053.  
  1054. `-mlong32'
  1055.      Type long is 32 bits, the same as type int.  This is the default.
  1056.  
  1057. `-mlong64'
  1058.      Type long is 64 bits, the same as type long long.  This option is
  1059.      useless, because no library support exists for it.
  1060.  
  1061. File: gcc.info,  Node: AMD29K Options,  Next: ARM Options,  Prev: Convex Options,  Up: Submodel Options
  1062.  
  1063. AMD29K Options
  1064. --------------
  1065.  
  1066.    These `-m' options are defined for the AMD Am29000:
  1067.  
  1068. `-mdw'
  1069.      Generate code that assumes the `DW' bit is set, i.e., that byte and
  1070.      halfword operations are directly supported by the hardware.  This
  1071.      is the default.
  1072.  
  1073. `-mndw'
  1074.      Generate code that assumes the `DW' bit is not set.
  1075.  
  1076. `-mbw'
  1077.      Generate code that assumes the system supports byte and halfword
  1078.      write operations.  This is the default.
  1079.  
  1080. `-mnbw'
  1081.      Generate code that assumes the systems does not support byte and
  1082.      halfword write operations.  `-mnbw' implies `-mndw'.
  1083.  
  1084. `-msmall'
  1085.      Use a small memory model that assumes that all function addresses
  1086.      are either within a single 256 KB segment or at an absolute
  1087.      address of less than 256k.  This allows the `call' instruction to
  1088.      be used instead of a `const', `consth', `calli' sequence.
  1089.  
  1090. `-mnormal'
  1091.      Use the normal memory model: Generate `call' instructions only when
  1092.      calling functions in the same file and `calli' instructions
  1093.      otherwise.  This works if each file occupies less than 256 KB but
  1094.      allows the entire executable to be larger than 256 KB.  This is
  1095.      the default.
  1096.  
  1097. `-mlarge'
  1098.      Always use `calli' instructions.  Specify this option if you expect
  1099.      a single file to compile into more than 256 KB of code.
  1100.  
  1101. `-m29050'
  1102.      Generate code for the Am29050.
  1103.  
  1104. `-m29000'
  1105.      Generate code for the Am29000.  This is the default.
  1106.  
  1107. `-mkernel-registers'
  1108.      Generate references to registers `gr64-gr95' instead of to
  1109.      registers `gr96-gr127'.  This option can be used when compiling
  1110.      kernel code that wants a set of global registers disjoint from
  1111.      that used by user-mode code.
  1112.  
  1113.      Note that when this option is used, register names in `-f' flags
  1114.      must use the normal, user-mode, names.
  1115.  
  1116. `-muser-registers'
  1117.      Use the normal set of global registers, `gr96-gr127'.  This is the
  1118.      default.
  1119.  
  1120. `-mstack-check'
  1121. `-mno-stack-check'
  1122.      Insert (or do not insert) a call to `__msp_check' after each stack
  1123.      adjustment.  This is often used for kernel code.
  1124.  
  1125. `-mstorem-bug'
  1126. `-mno-storem-bug'
  1127.      `-mstorem-bug' handles 29k processors which cannot handle the
  1128.      separation of a mtsrim insn and a storem instruction (most 29000
  1129.      chips to date, but not the 29050).
  1130.  
  1131. `-mno-reuse-arg-regs'
  1132. `-mreuse-arg-regs'
  1133.      `-mno-reuse-arg-regs' tells the compiler to only use incoming
  1134.      argument registers for copying out arguments.  This helps detect
  1135.      calling a function with fewer arguments than it was declared with.
  1136.  
  1137. `-msoft-float'
  1138.      Generate output containing library calls for floating point.
  1139.      *Warning:* the requisite libraries are not part of GNU CC.
  1140.      Normally the facilities of the machine's usual C compiler are
  1141.      used, but this can't be done directly in cross-compilation.  You
  1142.      must make your own arrangements to provide suitable library
  1143.      functions for cross-compilation.
  1144.  
  1145. File: gcc.info,  Node: ARM Options,  Next: M88K Options,  Prev: AMD29K Options,  Up: Submodel Options
  1146.  
  1147. ARM Options
  1148. -----------
  1149.  
  1150.    These `-m' options are defined for Advanced RISC Machines (ARM)
  1151. architectures:
  1152.  
  1153. `-m2'
  1154. `-m3'
  1155.      These options are identical.  Generate code for the ARM2 and ARM3
  1156.      processors.  This option is the default.  You should also use this
  1157.      option to generate code for ARM6 processors that are running with a
  1158.      26-bit program counter.
  1159.  
  1160. `-m6'
  1161.      Generate code for the ARM6 processor when running with a 32-bit
  1162.      program counter.
  1163.  
  1164. `-mapcs'
  1165.      Generate a stack frame that is compliant with the ARM Proceedure
  1166.      Call Standard for all functions, even if this is not strictly
  1167.      necessary for correct execution of the code.
  1168.  
  1169. `-mbsd'
  1170.      This option only applies to RISC iX.  Emulate the native BSD-mode
  1171.      compiler.  This is the default if `-ansi' is not specified.
  1172.  
  1173. `-mxopen'
  1174.      This option only applies to RISC iX.  Emulate the native
  1175.      X/Open-mode compiler.
  1176.  
  1177. `-mno-symrename'
  1178.      This option only applies to RISC iX.  Do not run the assembler
  1179.      post-processor, `symrename', after code has been assembled.
  1180.      Normally it is necessary to modify some of the standard symbols in
  1181.      preparation for linking with the RISC iX C library; this option
  1182.      suppresses this pass.  The post-processor is never run when the
  1183.      compiler is built for cross-compilation.
  1184.  
  1185.